| 12 | | === How do I set a buddy icon or avatar? === |
| 13 | | We call all user pictures, avatars, etc. buddy icons. There are two ways to set one for yourself: |
| 14 | | * '''Global''' - This will affect all of your accounts. On the Buddy List window, beside the status selector at the bottom, there is an area that will have a generic photo icon if you have no icon set. You can click that and select an icon from there. The icon will take effect for all accounts you have configured in Pidgin. |
| 15 | | * '''Per-account''' - This will affect only the account you modify. Go to Accounts->''your account''->Edit Account. On that dialog, check the box labeled "Use this buddy icon for this account:", then click the leftmost button below that checkbox. Select your buddy icon. |
| 16 | | |
| 17 | | In either case, the file must be smaller than 4KB to work on AIM and XMPP. It can have any dimensions, and can be in any format. However, if you wish Windows users to see it, it must be in a format Windows understands, such as .bmp, .gif, and .jpg. Pidgin will attempt to scale icons to fit within these constraints, but it is not always possible to do so. |
| 18 | | |
| 19 | | The following dimension guidelines are believed to be accurate as of June 2007: |
| 20 | | ||'''Protocol'''||'''Dimensions'''||'''Format'''||'''File Size'''|| |
| 21 | | ||AIM||48x48 to 50x50||gif, jpg, bmp, ico||7168 bytes (7.0KB)|| |
| 22 | | ||ICQ||48x48 to 50x50||gif, jpg, bmp, ico||7168 bytes (7.0KB)|| |
| 23 | | ||Yahoo!||96x96||png, gif, jpg|||| |
| 24 | | ||XMPP (including Google Talk)||32x32 to 96x96||png, gif, jpeg||8191 bytes (one byte short of 8.0KB)|| |
| 25 | | ||MSN||up to 96x96||png|||| |
| 26 | | |
| 27 | | Pidgin itself (for the chat window) will scale icons up or down to 32x32 for display in the buddy list and the infopane. In general, to maintain the aspect ratio, you should begin with a square icon. |
| 28 | | |
| 29 | | === A friend of mine uses my favorite episode of ''The Young and the Restless'' as her buddy icon, but I can't quite make it out in the infopane. What do I do? === |
| 30 | | |
| 31 | | The easiest thing to do is ask your friend to put it up on !YouTube or some equivalent service. Alternatively, you could buy it on DVD, if available. The mouse-over tooltip on the infopane also has her full-size buddy icon, for a quick fix. Additionally, clicking the icon in the infopane should also enlarge it. |
| 32 | | |
| 33 | | === What are the default keyboard shortcuts (key bindings)? === |
| 34 | | See [wiki:shortcuts this wiki page] for a list. |
| 35 | | |
| 36 | | === How do I make Enter make a newline and Ctrl+Enter send? === |
| 37 | | |
| 38 | | Locate or create your `gtkrc-2.0` file and insert: |
| 39 | | {{{ |
| 40 | | binding "my-bindings" |
| 41 | | { |
| 42 | | bind "Return" { "insert-at-cursor" ("\n") } |
| 43 | | bind "<ctrl>Return" { "message_send" () } |
| 44 | | } |
| 45 | | widget "*pidgin_conv_entry" binding "my-bindings" |
| 46 | | }}} |
| 47 | | |
| 48 | | === How do I make Pidgin use emacs-like keybindings? === |
| 49 | | Locate or create your `.gtkrc-2.0` file and insert the following: |
| 50 | | {{{ |
| 51 | | gtk-key-theme-name = "Emacs" |
| 52 | | }}} |
| 53 | | You will need to restart Pidgin when you have finished. Note that this will affect other GTK+ applications as well. |
| 54 | | |
| 55 | | === How do I bind keystrokes to menu items? === |
| 56 | | |
| 57 | | Locate or create your `gtkrc-2.0` file and insert: |
| 58 | | |
| 59 | | {{{ |
| 60 | | gtk-can-change-accels = 1 |
| 61 | | }}} |
| 62 | | |
| 63 | | After coercing Pidgin into rereading this file (for instance, by restarting it), you can hover over a menu item and hit the keystroke you want to bind to it, and your wish will be granted! (You might want to turn off `gtk-can-change-accels` again when you're done, since it's pretty easy to bind keys by mistake with it turned on.) |
| 64 | | |
| 65 | | If you're using a recent enough Gnome, you can instead open the ''Appearance'' preferences applet, switch to the ''Interface'' tab and toggle ''Editable menu shortcut keys''. In older versions of Gnome, use `gconf-editor` to set the `/desktop/gnome/interface/can_change_accels` key instead (which is what happens in newer Gnomes behind the scenes anyway). You don't need to restart Pidgin if you take the gconf path. |
| 66 | | |
| 67 | | === How do I make Escape close conversation windows? === |
| 68 | | As of 2.4.2 this option is included by default. The option is under Tools ⇒ Preferences ⇒ Interface Tab. |
| 69 | | |
| 70 | | === How do I change the language for the Highlight Misspelled words option? === |
| 71 | | Pidgin currently only supports spell checking in your locale language. This is because gtkspell 2 does not offer a good way for us to know which dictionaries are available or to switch between them. This functionality has long been promised for gtkspell version 3, which has been delayed somewhat indefinitely. See [http://gtkspell.sf.net gtkspell.sf.net]. |
| 72 | | |
| 73 | | There is, however a simple plugin called [http://plugins.guifications.org/trac/wiki/switchspell switchspell] that can change the spell check language on a per-buddy basis. |
| 74 | | |
| 75 | | === Why do all words I type get highlighted as misspelled? === |
| 76 | | We've seen several users with this issue. It seems to be that the dictionary for the spell checking language is missing. Most likely you need to install a package named "`aspell-XX`" where `XX` is the language you run Pidgin in, such as `en` for English or `es` for Spanish. |
| 77 | | |
| 78 | | === How do I register for a new account? === |
| | 14 | ==== How do I register for a new account? ==== |
| 89 | | === How can I unblock someone? === |
| | 25 | === Buddy Icons (Avatars), Buddy List and Blocking === |
| | 26 | |
| | 27 | ==== How do I set a buddy icon or avatar? ==== |
| | 28 | We call all user pictures, avatars, etc. buddy icons. There are two ways to set one for yourself: |
| | 29 | * '''Global''' - This will affect all of your accounts. On the Buddy List window, beside the status selector at the bottom, there is an area that will have a generic photo icon if you have no icon set. You can click that and select an icon from there. The icon will take effect for all accounts you have configured in Pidgin. |
| | 30 | * '''Per-account''' - This will affect only the account you modify. Go to Accounts->''your account''->Edit Account. On that dialog, check the box labeled "Use this buddy icon for this account:", then click the leftmost button below that checkbox. Select your buddy icon. |
| | 31 | |
| | 32 | In either case, the file must be smaller than 4KB to work on AIM and XMPP. It can have any dimensions, and can be in any format. However, if you wish Windows users to see it, it must be in a format Windows understands, such as .bmp, .gif, and .jpg. Pidgin will attempt to scale icons to fit within these constraints, but it is not always possible to do so. |
| | 33 | |
| | 34 | The following dimension guidelines are believed to be accurate as of June 2007: |
| | 35 | ||'''Protocol'''||'''Dimensions'''||'''Format'''||'''File Size'''|| |
| | 36 | ||AIM||48x48 to 50x50||gif, jpg, bmp, ico||7168 bytes (7.0KB)|| |
| | 37 | ||ICQ||48x48 to 50x50||gif, jpg, bmp, ico||7168 bytes (7.0KB)|| |
| | 38 | ||Yahoo!||96x96||png, gif, jpg|||| |
| | 39 | ||XMPP (including Google Talk)||32x32 to 96x96||png, gif, jpeg||8191 bytes (one byte short of 8.0KB)|| |
| | 40 | ||MSN||up to 96x96||png|||| |
| | 41 | |
| | 42 | Pidgin itself (for the chat window) will scale icons up or down to 32x32 for display in the buddy list and the infopane. In general, to maintain the aspect ratio, you should begin with a square icon. |
| | 43 | |
| | 44 | ==== A friend of mine uses my favorite episode of ''The Young and the Restless'' as her buddy icon, but I can't quite make it out in the infopane. What do I do? ==== |
| | 45 | |
| | 46 | The easiest thing to do is ask your friend to put it up on !YouTube or some equivalent service. Alternatively, you could buy it on DVD, if available. The mouse-over tooltip on the infopane also has her full-size buddy icon, for a quick fix. Additionally, clicking the icon in the infopane should also enlarge it. |
| | 47 | |
| | 48 | ==== How can I unblock someone? ==== |
| 109 | | === What happened to my timestamps? Can I change them? === |
| 110 | | As of 2.0.0, timestamps follow the system locale. This is a significant difference from previous versions of Pidgin, and though it was requested more than once, we know it will prove to be a controversial decision. Fortunately for all of you out there, we also provide plugins to change it. |
| 111 | | |
| 112 | | The two plugins we provide are the Timestamp plugin and the Message Timestamp Formats plugin. Timestamp allows you to have iChat style timestamps, but it is implemented to behave slightly differently. The Message Timestamp Formats plugin allows you to manipulate the timestamps in a couple different ways, such as restoring 24-hour timestamps and/or causing all timestamps to have dates in them. |
| 113 | | |
| 114 | | === Does Pidgin support animated smileys? === |
| 115 | | Yes, but there is a bug which can cause animation to be lost if Pidgin has to resize the image. Also, only the most recent 20 emoticons are animated. |
| 116 | | |
| 117 | | === What is a "Buddy Pounce"? === |
| 118 | | Pidgin introduced buddy pounces a few releases before AOL came out with "Buddy Alerts." Despite this, you could think of a buddy pounce as an alert and get an idea of the most minimal use of a buddy pounce. In reality, a buddy pounce is much like a macro, or a recorded action. When you set a pounce on someone, you can choose from a number of events, such as sign on or status change, and then you choose from a number of actions. These actions include everything from playing a sound (like an alert would do) to sending a message to the person, to executing a command. This action will occur the next time pidgin detects the event, i.e. the next time the person in your buddy list who you have pounced signs on. |
| 119 | | |
| 120 | | === Can I use Pidgin for e-mail, blogging, RSS feeds, or anything else that isn't IM-related? === |
| 121 | | No, you can't. We get requests for this often, but Pidgin is indeed a messaging client. Aside from the capabilities each protocol may support, the Pidgin developers have no intention to turn Pidgin into a multi-feature Internet client capable of doing everything under the sun. We also won't be helping to develop plugins to turn it into that. There are many Internet applications available for Linux, Windows, or whatever operating system you use that would undoubtedly do a better job. |
| 122 | | |
| 123 | | Note that [http://www.livejournal.com LiveJournal] provides an XMPP messaging service which makes it possible to make entries to your blog via IM, no matter what XMPP-supporting IM client you use. |
| 124 | | |
| 125 | | === How do I use/make smiley themes? === |
| 126 | | See [wiki:SmileyThemes the page on smileys]. |
| 127 | | |
| 128 | | === Can I "skin" Pidgin? === |
| 129 | | The UI can be customized using GTK themes and by [wiki:SmileyThemes Smiley Themes]. Application-specific skins will never be supported by Pidgin. This seems to confuse a lot of users, so here's an attempt at an explanation. |
| 130 | | |
| 131 | | Themes allow you to change font size, font face, the color of different elements of the UI, and sometimes their shape. All of this is perfectly reasonable, and encompasses the range of configuration that ''most'' users are requesting. Skins go beyond this. Skins allow you to move and possibly suppress different elements of the UI that the programmers have added for specific reasons. |
| 132 | | |
| 133 | | In so doing, skins create a support nightmare. The developer, talking to the user, cannot be sure that the user sees the same interface. Is it a bug that the user cannot see how to change font size, or is the user's skin suppressing that widget? This is an unacceptable situation. |
| 134 | | |
| 135 | | Conversely, while themes allow some silliness, for instance setting the background to the same color as the font, the results are relatively easily foreseen and avoided by theme authors. Further, by using the existing GTK theme mechanism, we gain two advantages: |
| 136 | | 1. We don't have to write it ourselves. Were we to write our own mechanism, we would be adding overhead in both the run time and the time necessary to debug. |
| 137 | | 1. We have a built in way of debugging theme problems, by checking if the same bug exists with other GTK programs. |
| 138 | | |
| 139 | | Lastly, since GTK themes only allow acceptable modifications, we do not have to worry that a user isn't seeing part of the UI because it is either showing or not showing ''because of our code''. |
| 140 | | |
| 141 | | Themes and information on using them can be found at http://themes.freshmeat.net, http://art.gnome.org, or by searching on your favorite search engine, such as Google. |
| 142 | | |
| 143 | | The default location on Windows to add the theme is: `C:\Program Files\Common Files\GTK\2.0\share\themes` (TODO: This isn't correct, it should be the user-specific directory, not the global directory). |
| 144 | | |
| 145 | | === How do I change the font Pidgin uses? The background color? === |
| 146 | | The font preference in Pidgin applies only for the formatting of outgoing messages on those protocols which support said formatting. The display fonts used by the rest of Pidgin are those specified by GTK+, the toolkit we use to create the user interface. If you're using Gnome, you can change these in System ⇒ Preferences ⇒ Appearance ⇒ Fonts; the font used for conversations is the ''document'' font, while the rest of Pidgin uses the ''application'' font. |
| 147 | | |
| 148 | | If you're not running Gnome and want to change the fonts used, you need to edit your `~/.gtkrc-2.0` (or `~/.purple/gtkrc-2.0`) file. On Windows, see [wiki:"Using Pidgin#WhatisagtkrcfileandwherecanIfindit" this FAQ entry] for the location of the gtkrc file. If that file does not exist, simply create it. |
| 149 | | |
| 150 | | As an example, you can put this into `.gtkrc-2.0` to change the font size for all GTK+ applications: |
| 151 | | {{{ |
| 152 | | # Sets the font used by all gtk applications. |
| 153 | | gtk-font-name = "Verdana 9" |
| 154 | | }}} |
| 155 | | |
| 156 | | Alternatively, you can do this to change the font size for other elements: |
| 157 | | {{{ |
| 158 | | # This is the style section. You need this for the examples below. |
| 159 | | # If you are going to copy the example, copy the entire block, |
| 160 | | # including the "{" and "}" lines. |
| 161 | | style "imhtml-fix" |
| 162 | | { |
| 163 | | font_name = "Sans 10" |
| 164 | | } |
| 165 | | |
| 166 | | # This will apply the font style just shown to various components. |
| 167 | | # If you are going to copy the example, copy the line that does |
| 168 | | # what you want. |
| 169 | | |
| 170 | | # Conversation entry box--where you type. |
| 171 | | widget "*pidgin_conv_entry" style "imhtml-fix" |
| 172 | | |
| 173 | | # Conversation history pane--where you read the conversation. |
| 174 | | widget "*pidgin_conv_imhtml" style "imhtml-fix" |
| 175 | | |
| 176 | | # Log viewer--where you read stored logs |
| 177 | | widget "*pidgin_log_imhtml" style "imhtml-fix" |
| 178 | | |
| 179 | | # formatting-capable entry areas (IMHtml widgets) in request dialogs |
| 180 | | widget "*pidgin_request_imhtml" style "imhtml-fix" |
| 181 | | |
| 182 | | # formatting-capable notification areas in dialogs (again, IMHtml widgets) |
| 183 | | widget "*pidgin_notify_imhtml" style "imhtml-fix" |
| 184 | | }}} |
| 185 | | |
| 186 | | Background colors can be changed similarly, by finding the correct widget names and setting appropriate bg elements. Other widgets in Pidgin can be controlled in a similar manner. For example, to change the background color for a group, do something similar to the following: |
| 187 | | |
| 188 | | {{{ |
| 189 | | style "NoPidginGroupColor" |
| 190 | | { |
| 191 | | bg[ACTIVE] = "#FFFFFF" |
| 192 | | } |
| 193 | | |
| 194 | | widget "*pidgin_blist_treeview" style "NoPidginGroupColor" |
| 195 | | }}} |
| 196 | | |
| 197 | | You could also switch GTK+ themes. Themes and information on using them can be found at http://themes.freshmeat.net, http://art.gnome.org, or by searching on your favorite search engine, such as Google. |
| 198 | | |
| 199 | | === Pidgin beeps whenever I press backspace, how do I disable that? === |
| 200 | | |
| 201 | | See http://developer.pidgin.im/ticket/3683 . |
| 202 | | |
| 203 | | === Can I turn the tray icon off? === |
| 204 | | Yes. By default the tray icon will load if you have a Notification Area or a System Tray in your desktop environment. Look at the Interface tab in Tools->Preferences. Change the 'System Tray Icon' setting to 'Always', 'Never', or 'On unread messages' as you prefer. |
| 205 | | |
| 206 | | === Can I import or export my buddy list? === |
| | 57 | ==== Can I import or export my buddy list? ==== |
| 233 | | === What do those colors in the conversation tab mean? === |
| 234 | | * '''Red''' - A message is waiting for you in a chat that does not contain your name |
| 235 | | * '''Blue''' - Someone (in one-on-one IM) sent you a message or (in chats) said your name/nickname |
| 236 | | * '''Green''' - The buddy is typing |
| 237 | | * '''Yellow''' - The buddy began typing, and then stopped |
| 238 | | * '''Gray''' - There has been a join or a part in that chat, or the buddy has signed off |
| 239 | | |
| 240 | | === I get "accept/reject certificate" prompts all the time. What do I do? === |
| 241 | | This may mean that the Pidgin root certificate set is incomplete. If so, we'd like to hear about it. Do the following: |
| 242 | | 1. Accept the Certificate |
| 243 | | 2. Go to Tools->Certificates |
| 244 | | 3. Select the relevant server and export the certificate to a file. |
| 245 | | 4. [/simpleticket File a ticket]. Attach the exported certificate, and specify which protocol you are connecting to, as well as the server the certificate is for. |
| 246 | | |
| 247 | | === Why does Pidgin crash when I start it? === |
| | 84 | ==== Why are protocol icons not displayed in the buddy list and conversation windows any more? ==== |
| | 85 | See [http://pidgin.im/~seanegan/blog/identity.html Sean's blog entry on the subject] for the rationale behind this change. However, as of Pidgin 2.2.0 you can add protocol icons to the buddy list with Buddies-> Show->Protocol Icons. The [http://plugins.guifications.org/trac/wiki/convbadger convbadger plugin] from the [http://plugins.guifications.org/trac/wiki/PluginPack Purple Plugin Pack] adds protocol icons to conversation windows. |
| | 86 | |
| | 87 | === Keyboard Shortcuts === |
| | 88 | |
| | 89 | ==== What are the default keyboard shortcuts (key bindings)? ==== |
| | 90 | See [wiki:shortcuts this wiki page] for a list. |
| | 91 | |
| | 92 | ==== How do I make Enter make a newline and Ctrl+Enter send? ==== |
| | 93 | |
| | 94 | Locate or create your `gtkrc-2.0` file and insert: |
| | 95 | {{{ |
| | 96 | binding "my-bindings" |
| | 97 | { |
| | 98 | bind "Return" { "insert-at-cursor" ("\n") } |
| | 99 | bind "<ctrl>Return" { "message_send" () } |
| | 100 | } |
| | 101 | widget "*pidgin_conv_entry" binding "my-bindings" |
| | 102 | }}} |
| | 103 | |
| | 104 | ==== How do I make Pidgin use emacs-like keybindings? ==== |
| | 105 | Locate or create your `.gtkrc-2.0` file and insert the following: |
| | 106 | {{{ |
| | 107 | gtk-key-theme-name = "Emacs" |
| | 108 | }}} |
| | 109 | You will need to restart Pidgin when you have finished. Note that this will affect other GTK+ applications as well. |
| | 110 | |
| | 111 | ==== How do I bind keystrokes to menu items? ==== |
| | 112 | |
| | 113 | Locate or create your `gtkrc-2.0` file and insert: |
| | 114 | |
| | 115 | {{{ |
| | 116 | gtk-can-change-accels = 1 |
| | 117 | }}} |
| | 118 | |
| | 119 | After coercing Pidgin into rereading this file (for instance, by restarting it), you can hover over a menu item and hit the keystroke you want to bind to it, and your wish will be granted! (You might want to turn off `gtk-can-change-accels` again when you're done, since it's pretty easy to bind keys by mistake with it turned on.) |
| | 120 | |
| | 121 | If you're using a recent enough Gnome, you can instead open the ''Appearance'' preferences applet, switch to the ''Interface'' tab and toggle ''Editable menu shortcut keys''. In older versions of Gnome, use `gconf-editor` to set the `/desktop/gnome/interface/can_change_accels` key instead (which is what happens in newer Gnomes behind the scenes anyway). You don't need to restart Pidgin if you take the gconf path. |
| | 122 | |
| | 123 | ==== How do I make Escape close conversation windows? ==== |
| | 124 | As of 2.4.2 this option is included by default. The option is under Tools ⇒ Preferences ⇒ Interface Tab. |
| | 125 | |
| | 126 | === Spell Checking === |
| | 127 | |
| | 128 | ==== How do I change the language for the Highlight Misspelled words option? ==== |
| | 129 | Pidgin currently only supports spell checking in your locale language. This is because gtkspell 2 does not offer a good way for us to know which dictionaries are available or to switch between them. This functionality has long been promised for gtkspell version 3, which has been delayed somewhat indefinitely. See [http://gtkspell.sf.net gtkspell.sf.net]. |
| | 130 | |
| | 131 | There is, however a simple plugin called [http://plugins.guifications.org/trac/wiki/switchspell switchspell] that can change the spell check language on a per-buddy basis. |
| | 132 | |
| | 133 | ==== Why do all words I type get highlighted as misspelled? ==== |
| | 134 | We've seen several users with this issue. It seems to be that the dictionary for the spell checking language is missing. Most likely you need to install a package named "`aspell-XX`" where `XX` is the language you run Pidgin in, such as `en` for English or `es` for Spanish. |
| | 135 | |
| | 136 | === Statuses === |
| | 137 | |
| | 138 | ==== How does Pidgin decide which saved statuses to show in the status selector? ==== |
| | 139 | Pidgin shows six "popular" saved statuses in the status selector. These are your six most recently used statuses, offset by a weight. Pidgin sorts all your saved statuses by the timestamp when they were last used. And then, for each time you've used a status, the timestamp is increased by one day. |
| | 140 | |
| | 141 | If you are upgrading from 1.x or lower, Pidgin is unable to determine which are the most popular states, as these older releases did not save that information. As a result, the initial contents of the menu will be somewhat random. It will settle over the first few uses of (distinct) states into the behavior described above. |
| | 142 | |
| | 143 | ==== Why are no states listed when I go to set a state for Auto Away? ==== |
| | 144 | Pidgin can only use saved states for Auto Away. You need to create and save a named state first. |
| | 145 | |
| | 146 | === Smileys (Emoticons) === |
| | 147 | |
| | 148 | ==== Does Pidgin support animated smileys? ==== |
| | 149 | Yes, but there is a bug which can cause animation to be lost if Pidgin has to resize the image. Also, only the most recent 20 emoticons are animated. |
| | 150 | |
| | 151 | ==== How do I use/make smiley themes? ==== |
| | 152 | See [wiki:SmileyThemes the page on smileys]. |
| | 153 | |
| | 154 | === Look & Feel === |
| | 155 | |
| | 156 | ==== Can I "skin" Pidgin? ==== |
| | 157 | The UI can be customized using GTK themes and by [wiki:SmileyThemes Smiley Themes]. Application-specific skins will never be supported by Pidgin. This seems to confuse a lot of users, so here's an attempt at an explanation. |
| | 158 | |
| | 159 | Themes allow you to change font size, font face, the color of different elements of the UI, and sometimes their shape. All of this is perfectly reasonable, and encompasses the range of configuration that ''most'' users are requesting. Skins go beyond this. Skins allow you to move and possibly suppress different elements of the UI that the programmers have added for specific reasons. |
| | 160 | |
| | 161 | In so doing, skins create a support nightmare. The developer, talking to the user, cannot be sure that the user sees the same interface. Is it a bug that the user cannot see how to change font size, or is the user's skin suppressing that widget? This is an unacceptable situation. |
| | 162 | |
| | 163 | Conversely, while themes allow some silliness, for instance setting the background to the same color as the font, the results are relatively easily foreseen and avoided by theme authors. Further, by using the existing GTK theme mechanism, we gain two advantages: |
| | 164 | 1. We don't have to write it ourselves. Were we to write our own mechanism, we would be adding overhead in both the run time and the time necessary to debug. |
| | 165 | 1. We have a built in way of debugging theme problems, by checking if the same bug exists with other GTK programs. |
| | 166 | |
| | 167 | Lastly, since GTK themes only allow acceptable modifications, we do not have to worry that a user isn't seeing part of the UI because it is either showing or not showing ''because of our code''. |
| | 168 | |
| | 169 | Themes and information on using them can be found at http://themes.freshmeat.net, http://art.gnome.org, or by searching on your favorite search engine, such as Google. |
| | 170 | |
| | 171 | The default location on Windows to add the theme is: `C:\Program Files\Common Files\GTK\2.0\share\themes` (TODO: This isn't correct, it should be the user-specific directory, not the global directory). |
| | 172 | |
| | 173 | ==== How do I change the font Pidgin uses? The background color? ==== |
| | 174 | The font preference in Pidgin applies only for the formatting of outgoing messages on those protocols which support said formatting. The display fonts used by the rest of Pidgin are those specified by GTK+, the toolkit we use to create the user interface. If you're using Gnome, you can change these in System ⇒ Preferences ⇒ Appearance ⇒ Fonts; the font used for conversations is the ''document'' font, while the rest of Pidgin uses the ''application'' font. |
| | 175 | |
| | 176 | If you're not running Gnome and want to change the fonts used, you need to edit your `~/.gtkrc-2.0` (or `~/.purple/gtkrc-2.0`) file. On Windows, see [wiki:"Using Pidgin#WhatisagtkrcfileandwherecanIfindit" this FAQ entry] for the location of the gtkrc file. If that file does not exist, simply create it. |
| | 177 | |
| | 178 | As an example, you can put this into `.gtkrc-2.0` to change the font size for all GTK+ applications: |
| | 179 | {{{ |
| | 180 | # Sets the font used by all gtk applications. |
| | 181 | gtk-font-name = "Verdana 9" |
| | 182 | }}} |
| | 183 | |
| | 184 | Alternatively, you can do this to change the font size for other elements: |
| | 185 | {{{ |
| | 186 | # This is the style section. You need this for the examples below. |
| | 187 | # If you are going to copy the example, copy the entire block, |
| | 188 | # including the "{" and "}" lines. |
| | 189 | style "imhtml-fix" |
| | 190 | { |
| | 191 | font_name = "Sans 10" |
| | 192 | } |
| | 193 | |
| | 194 | # This will apply the font style just shown to various components. |
| | 195 | # If you are going to copy the example, copy the line that does |
| | 196 | # what you want. |
| | 197 | |
| | 198 | # Conversation entry box--where you type. |
| | 199 | widget "*pidgin_conv_entry" style "imhtml-fix" |
| | 200 | |
| | 201 | # Conversation history pane--where you read the conversation. |
| | 202 | widget "*pidgin_conv_imhtml" style "imhtml-fix" |
| | 203 | |
| | 204 | # Log viewer--where you read stored logs |
| | 205 | widget "*pidgin_log_imhtml" style "imhtml-fix" |
| | 206 | |
| | 207 | # formatting-capable entry areas (IMHtml widgets) in request dialogs |
| | 208 | widget "*pidgin_request_imhtml" style "imhtml-fix" |
| | 209 | |
| | 210 | # formatting-capable notification areas in dialogs (again, IMHtml widgets) |
| | 211 | widget "*pidgin_notify_imhtml" style "imhtml-fix" |
| | 212 | }}} |
| | 213 | |
| | 214 | Background colors can be changed similarly, by finding the correct widget names and setting appropriate bg elements. Other widgets in Pidgin can be controlled in a similar manner. For example, to change the background color for a group, do something similar to the following: |
| | 215 | |
| | 216 | {{{ |
| | 217 | style "NoPidginGroupColor" |
| | 218 | { |
| | 219 | bg[ACTIVE] = "#FFFFFF" |
| | 220 | } |
| | 221 | |
| | 222 | widget "*pidgin_blist_treeview" style "NoPidginGroupColor" |
| | 223 | }}} |
| | 224 | |
| | 225 | You could also switch GTK+ themes. Themes and information on using them can be found at http://themes.freshmeat.net, http://art.gnome.org, or by searching on your favorite search engine, such as Google. |
| | 226 | |
| | 227 | === Pidgin Crashing === |
| | 228 | |
| | 229 | ==== Why does Pidgin crash when I start it? ==== |
| 262 | | === Why are protocol icons not displayed in the buddy list and conversation windows any more? === |
| 263 | | See [http://pidgin.im/~seanegan/blog/identity.html Sean's blog entry on the subject] for the rationale behind this change. However, as of Pidgin 2.2.0 you can add protocol icons to the buddy list with Buddies-> Show->Protocol Icons. The [http://plugins.guifications.org/trac/wiki/convbadger convbadger plugin] from the [http://plugins.guifications.org/trac/wiki/PluginPack Purple Plugin Pack] adds protocol icons to conversation windows. |
| 264 | | |
| 265 | | === When will newer MSN features be supported? === |
| | 244 | === Voice and Video (Microphone and Webcam) Support (Not Implemented Yet) === |
| | 245 | |
| | 246 | ==== Does Pidgin support webcams (video)? ==== |
| | 247 | ==== Does Pidgin support MSN video chat? ==== |
| | 248 | Not currently. It is planned. See below. |
| | 249 | |
| | 250 | ==== Does Pidgin support microphones (voice)? ==== |
| | 251 | ==== Does Pidgin support libjingle? ==== |
| | 252 | Not currently. It is planned. See below. |
| | 253 | |
| | 254 | ==== When will voice and video be implemented? ==== |
| | 255 | We plan to implement these features eventually, but it is a daunting task. Not all of our developers care about these features, and because of that don't want to work on them. The time available to those developers who do want to work on these features is limited, and so any work on these features proceeds slowly. |
| | 256 | |
| | 257 | We aim to have an abstracted, protocol-agnostic API for voice and video, which makes the task harder. Also adding to the difficulty is that now that we have a completely split core (libpurple) and UI (Pidgin and Finch), we refuse to take a step backward and violate this split. The protocol plugins can NOT have any code in them that is UI-dependent, or we break the libpurple/UI split. This imposes additional restrictions that make it a very painstaking process to implement voice and video correctly. |
| | 258 | |
| | 259 | In short, we have no idea when this will happen. It could be tomorrow, or it could be in 2099. That's really the best answer we can give right now. |
| | 260 | |
| | 261 | Some history and current status on voice and video should be collected at the ProgressReport page. |
| | 262 | |
| | 263 | === Miscellaneous === |
| | 264 | |
| | 265 | ==== Can I change the height of the text input area? ==== |
| | 266 | You can't manually resize the text input area, nor disable auto-resizing. The area auto-resizes up to a height of half the window height before the scrollbar appears. |
| | 267 | |
| | 268 | ==== When will newer MSN features be supported? ==== |
| | 282 | ==== What happened to my timestamps? Can I change them? ==== |
| | 283 | As of 2.0.0, timestamps follow the system locale. This is a significant difference from previous versions of Pidgin, and though it was requested more than once, we know it will prove to be a controversial decision. Fortunately for all of you out there, we also provide plugins to change it. |
| | 284 | |
| | 285 | The two plugins we provide are the Timestamp plugin and the Message Timestamp Formats plugin. Timestamp allows you to have iChat style timestamps, but it is implemented to behave slightly differently. The Message Timestamp Formats plugin allows you to manipulate the timestamps in a couple different ways, such as restoring 24-hour timestamps and/or causing all timestamps to have dates in them. |
| | 286 | |
| | 287 | ==== What is a "Buddy Pounce"? ==== |
| | 288 | Pidgin introduced buddy pounces a few releases before AOL came out with "Buddy Alerts." Despite this, you could think of a buddy pounce as an alert and get an idea of the most minimal use of a buddy pounce. In reality, a buddy pounce is much like a macro, or a recorded action. When you set a pounce on someone, you can choose from a number of events, such as sign on or status change, and then you choose from a number of actions. These actions include everything from playing a sound (like an alert would do) to sending a message to the person, to executing a command. This action will occur the next time pidgin detects the event, i.e. the next time the person in your buddy list who you have pounced signs on. |
| | 289 | |
| | 290 | ==== Can I use Pidgin for e-mail, blogging, RSS feeds, or anything else that isn't IM-related? ==== |
| | 291 | No, you can't. We get requests for this often, but Pidgin is indeed a messaging client. Aside from the capabilities each protocol may support, the Pidgin developers have no intention to turn Pidgin into a multi-feature Internet client capable of doing everything under the sun. We also won't be helping to develop plugins to turn it into that. There are many Internet applications available for Linux, Windows, or whatever operating system you use that would undoubtedly do a better job. |
| | 292 | |
| | 293 | Note that [http://www.livejournal.com LiveJournal] provides an XMPP messaging service which makes it possible to make entries to your blog via IM, no matter what XMPP-supporting IM client you use. |
| | 294 | |
| | 295 | ==== Pidgin beeps whenever I press backspace, how do I disable that? ==== |
| | 296 | |
| | 297 | See http://developer.pidgin.im/ticket/3683 . |
| | 298 | |
| | 299 | ==== Can I turn the tray icon off? ==== |
| | 300 | Yes. By default the tray icon will load if you have a Notification Area or a System Tray in your desktop environment. Look at the Interface tab in Tools->Preferences. Change the 'System Tray Icon' setting to 'Always', 'Never', or 'On unread messages' as you prefer. |
| | 301 | |
| | 302 | ==== What do those colors in the conversation tab mean? ==== |
| | 303 | * '''Red''' - A message is waiting for you in a chat that does not contain your name |
| | 304 | * '''Blue''' - Someone (in one-on-one IM) sent you a message or (in chats) said your name/nickname |
| | 305 | * '''Green''' - The buddy is typing |
| | 306 | * '''Yellow''' - The buddy began typing, and then stopped |
| | 307 | * '''Gray''' - There has been a join or a part in that chat, or the buddy has signed off |
| | 308 | |
| | 309 | ==== I get "accept/reject certificate" prompts all the time. What do I do? ==== |
| | 310 | This may mean that the Pidgin root certificate set is incomplete. If so, we'd like to hear about it. Do the following: |
| | 311 | 1. Accept the Certificate |
| | 312 | 2. Go to Tools->Certificates |
| | 313 | 3. Select the relevant server and export the certificate to a file. |
| | 314 | 4. [/simpleticket File a ticket]. Attach the exported certificate, and specify which protocol you are connecting to, as well as the server the certificate is for. |
| | 315 | |
| 281 | | === How does Pidgin for Windows determine which language to use? === |
| 282 | | For the user who installed Pidgin, the language selected during installation will be the default. |
| 283 | | This can be overridden by setting the `PIDGINLANG` environment variable (for example, `PIDGINLANG=de`). |
| 284 | | If neither of these are specified, it will fall back to the default Windows user locale setting. |
| 285 | | |
| 286 | | === Where are my settings and data (including logs) saved? === |
| 287 | | === Where is my `.purple` directory? === |
| 288 | | Data is stored in your user's "Application Data" directory in a `.purple` subdirectory. The location of this will vary according to your setup and version of Windows. |
| 289 | | * For Windows 2000/XP/Vista(?), entering `%APPDATA%` in your Windows Explorer address bar will take you to the right directory (probably something like `C:\Documents and Settings\username\Application Data`). |
| 290 | | * For Windows 98/ME it will be something like `C:\Windows\Profiles\username`. |
| 291 | | This can be overridden by setting the `PURPLEHOME` environment variable. |
| 292 | | |
| 293 | | Logs are stored in a subdirectory called `logs`. |
| 294 | | |
| 295 | | === How do I run multiple instances of Pidgin on Windows? === |
| 296 | | Pidgin will, by default, prevent multiple instances from running simultaneously. |
| 297 | | You can override this restriction by defining the `PIDGIN_MULTI_INST` environment variable or by specifying the `-m` command line parameter. |
| 298 | | If you do this, you may find the `-c` parameter useful to specify unique configuration directories for each instance (e.g. `-c c:\home\.pidgin-alt`). |
| 299 | | |
| 300 | | === What should I do if Pidgin crashes? === |
| 301 | | Follow the instructions [wiki:TipsForBugReports#WhattodoifPidgincrashes here] to submit a bug report. |
| 302 | | |
| 303 | | === Why can't I connect? My firewall is configured to allow Pidgin access. === |
| 304 | | {{{ |
| 305 | | #!html |
| 306 | | <a name="windowsfirewall" /> |
| 307 | | }}} |
| | 318 | === Proxies and Connection Settings and Problems === |
| | 319 | |
| | 320 | ==== Why can't I connect? My firewall is configured to allow Pidgin access. ==== #windowsfirewall |
| 323 | | === Why did my smiley theme disappear after I upgraded Pidgin? === |
| 324 | | Smiley themes should be installed to the user's .purple directory, not in the location Pidgin is installed to. This means that you install smiley themes only to `%APPDATA%\.purple\smileys`. Additions to or removals from Pidgin's installation location will be lost during an upgrade. |
| 325 | | |
| 326 | | === How do I change the look and feel? === |
| 327 | | See [#CanIskinPidgin this FAQ entry]. |
| 328 | | |
| 329 | | === What is a gtkrc file and where can I find it? === |
| 330 | | The windowing toolkit that Pidgin uses, GTK+, is configurable via a text file. |
| 331 | | |
| 332 | | There is a global file found in the `etc\gtk-2.0` directory your GTK+ Runtime install directory (`C:\Program Files\Common Files\GTK\2.0`, by default). |
| 333 | | There is also per-user file (named `.gtkrc-2.0`) in your user's home directory, the location of this varies according to the version of Windows you're using and the configuration. |
| 334 | | * For Windows 2000/XP/Vista(?), entering `%USERPROFILE%` in your Windows Explorer address bar will take you to the right directory (probably something like `C:\Documents and Settings\username`). |
| 335 | | * For Windows 98/ME it will be something like `C:\Windows\Profiles\username`. |
| 336 | | * If you have the `HOME` environment variable set, it will override the default per-user file location. |
| 337 | | |
| 338 | | **Note that Windows Explorer will not allow you create a file that starts with a period; you'll need to use a text editor or rename the file in a cmd shell. |
| 339 | | |
| 340 | | There is also a pidgin-specific file that is located in the configuration directory (`%APPDATA%\.purple\gtkrc-2.0`). |
| 341 | | |
| 342 | | It is recommended that you edit your per-user file or the pidgin-specific file instead of the global file as the global file will be replaced when GTK+ is upgraded. |
| 343 | | |
| 344 | | === Running Windows Pidgin From a USB Drive (Portable Mode) === |
| | 336 | ==== Can Pidgin use my Windows (IE) Proxy Settings? ==== |
| | 337 | Yes, if you set the proxy preference to "Use Environmental Settings", Pidgin will parse the HTTP Proxy setting from Windows as long as you have a specific server set; auto-detection and configuration via `.pac` URL do not work, nor do proxy bypass settings. |
| | 338 | |
| | 339 | === Portable Mode === |
| | 340 | |
| | 341 | ==== Running Windows Pidgin From a USB Drive (Portable Mode) ==== |
